home *** CD-ROM | disk | FTP | other *** search
/ Magnum One / Magnum One (Mid-American Digital) (Disc Manufacturing).iso / d6 / chrnos.arc / CH.DOC next >
Encoding:
Text File  |  1990-11-15  |  24.4 KB  |  483 lines

  1. CHRONOS User Instructions.
  2. Revised: 15 Nov 1990 
  3. Copyright 1990, Steve Estvanik / Cascoly Software / All rights reserved.
  4.  
  5. Contents:
  6.  
  7. 1. INTRODUCTION
  8. 2. GETTING STARTED 
  9.    2.1 PEOPLE
  10.    2.2 EVENTS
  11.    2.3 EDITING
  12. 3. INTERACTIVE HISTORY 
  13.    3.1 DISPLAY
  14.    3.2 SELECTIONS
  15.    3.3 REPORTS 
  16. 4. FILES
  17.    4.1 FUNCTIONS
  18.    4.2 EDITING OUTSIDE CHRONOS
  19. 5. REQUIREMENTS
  20. 6. SHAREWARE
  21. 7. REFERENCES
  22.  
  23.  
  24. 1. INTRODUCTION
  25.  
  26. How old was Paul Revere when he rode into history?  How old was Napoleon when 
  27. the Declaration of Independence was signed? How many years separated Cortez 
  28. and Michelangelo?  In War & Peace, how old is Natasha when Napoleon captures 
  29. Moscow?  Cascoly's CHRONOS historical timelines program examines these 
  30. questions and many more.  Unlike conventional paper chronologies, CHRONOS 
  31. lets you decide which people and events to include.  You can sort and select 
  32. by individual people and events, or groups and factions, developing new 
  33. insights and tracing patterns across different eras and cultures.  CHRONOS 
  34. will be useful to history and art students, genealogsits, teachers, writers 
  35. and anyone interested in exploring historical relations or cultural events. 
  36.  
  37.  
  38. 2. GETTING STARTED 
  39.  
  40. CHRONOS combines people and events into files called datasets.  These are  
  41. the two basic elements of CHRONOS.  Figure 1 shows the main CHRONOS menu.  
  42. File options are explained in section 4.  This section describes how to use 
  43. the People & Events portions of the program to create new datasets or to 
  44. modify existing ones.  Examples can be found in the datasets provided with 
  45. the program.  These datasets are described in more detail in the References, 
  46. (Section 7) which also contains information that might be useful in creating 
  47. your own datasets. If you want to look at an existing application, you can 
  48. go directly to section 3.  The remainder of this section describes how to 
  49. create a new dataset from scratch, and how to add new people and events. 
  50.  
  51. 2.1 PEOPLE
  52. CHRONOS considers 2 main types of information -- People and Events.  As you 
  53. might expect, People items store information about historical persons or 
  54. fictional characters.  You can add or edit these records using the data 
  55. entry window shown in Figure 2.  If you don't know the exact birth or death 
  56. years, you can enter an approximate one.  (Note that, since the month and 
  57. day are left out, any age calculations can only be accurate to within a 
  58. year.  For years before 1700, there will be additional discrepancies, since 
  59. the acceptance of the Gregorian calendar reform did not occur everywhere at 
  60. the same time.  English speaking countries did not start using the new 
  61. calendar until the mid 1700's and Russia accepted the reform only after the 
  62. 1917 Revolution.)  Also, if you decide to create a current dataset, 
  63. containing living persons, you should set the 'death' year to some 
  64. arbitrarily high value, such as 2030 or 2050.
  65.  
  66. You can assign people to factions that you define using the Faction option 
  67. of the People submenu (Figure 2).  This lets you group people into logical 
  68. categories of your choosing.  These might be national or political, such as 
  69. Union, Confederate, British or French.  Or factions could be by occupation, 
  70. such as artist, musician, statesman and poet.  Selection options (section 
  71. 3.2) let you display, sort and print by selected factions or the entire 
  72. dataset.  You can assign a color to factions that will help to distinguish 
  73. them on the screen.  
  74.  
  75. 2.3 EVENTS
  76. The second main data element is the event.  This is a specific historical 
  77. happening.  It could be a battle, a political act, or the publication date 
  78. of a famous novel.  You can append a description, along with the year of the 
  79. event.  Events use groups in a similar fashion to factions for people.  
  80. Groups allow easier sorting and selection.  For example, in the Revolutions 
  81. dataset you can choose to display only Americans, or only French events.   
  82. Or events can be modified to use categories, such as political, cultural and 
  83. religious.  Thus you might have factions defined by nationality and groups 
  84. by type, or you could define factions by type and groups by nationality, 
  85. depending on your goals.  In the samples, REVOLT.CHR uses the first 
  86. ordering, and RENAISS.CHR uses the second.
  87.  
  88. 2.3 EDITING
  89.  
  90. People and Event items are added, edited and deleted in a similar fashion.
  91. From the parent menu (Figure 1), choose either the People or Events submenu 
  92. (Figures 2 and 4).  Then choose from Add, Edit or Delete.  When adding a new 
  93. item, a blank entry window appears and you can fill in the requested 
  94. information.  Events will be sorted by their year, people by their year of 
  95. birth.  When you're finished with a window, press <Esc> or the right mouse 
  96. button to accept it. 
  97.  
  98. When you choose edit or delete, a popup picklist (Figure 3) shows a list of 
  99. all people or events and you can choose the one you wish to edit or delete. 
  100. When you need to add or edit a faction or group, another popup appears, so 
  101. you don't need to remember the numbers for all factions or groups.
  102.  
  103. 2.4 LIMITS
  104.  
  105. CHRONOS can handle up to 300 people and 300 events per dataset.  However, 
  106. the window area required to display these will depend on the span of years 
  107. these people and events occupy.  If the span is less than 200 years, there 
  108. should be no problem.  If it is greater than 200, you might receive a 
  109. message :
  110.  
  111.       "Unable to create [People/Event] window"
  112.  
  113. This might be due to an attempt to show too large a span for the number of 
  114. people or events you have.  It could also be due to an input error for one 
  115. of the people or events.  Check this by printing a list of all people and 
  116. events and checking the years entered.
  117.  
  118. 3. INTERACTIVE HISTORY 
  119. Once a dataset is populated, you can begin your explorations using the 
  120. display and select options (Figure 1).  To reduce the startup time for new 
  121. users, CHRONOS comes with 2 datasets already created:
  122.  
  123. REVOLT.CHR covers the historical period from the American Revolution thru 
  124. the French Revolution and Napoleonic era to the Civil War.  
  125.  
  126. RENAISS.CHR covers the Renaissance period in Europe from about 1500 to the 
  127. end of the 30 Years War in 1648.  It emphasizes the interaction and ferment 
  128. among political, religious and cultural events.
  129.  
  130.  
  131. 3.1 DISPLAY
  132.  
  133. After editing People or Events, or after making a selection, choose DISPLAY 
  134. from the menu to show the latest subset of data.  When you make selections, 
  135. it just restricts the elements that are going to be displayed, they are 
  136. still part of the dataset for subsequent selections.  
  137.  
  138. Most of the commands and actions in this program are similar for keyboard 
  139. and mouse operation.  You select a function and execute it. However, the 
  140. dataset display lets you explore and the commands to control mouse and 
  141. keyboard are quite different.  Press <F1> for a summary of keyboard and 
  142. mouse commands.
  143.  
  144. MOUSE 
  145.  
  146. The CHRONOS display shows people and events on 2 linked but independent   
  147. scrolling windows.  The left button controls movement of a window, and 
  148. scrolling.  The right button controls selection and display of individual 
  149. items.  In either mode, the current section is determined by the placement 
  150. of the mouse cursor.  
  151.  
  152. Editing:
  153. Use the <Left button> to select items, and the <Right Button> or escape to 
  154. exit.  When using popups, a scroll bar on the right side of the popup lets 
  155. you use the mouse to jump to another part of the popup.  
  156.  
  157. Scrolling:
  158. Figure 5 shows the scroll command map.  If you want to scroll left or right, 
  159. click Left while in one of the areas marked 'b'.  Both top and bottom 
  160. sections scroll horizontally at the same time, so people and events are 
  161. always synchronous.  Areas marked 'c' control vertical movement.  Here, each 
  162. section, people or events, scrolls independently.  The 4 corners of each 
  163. section are similar to <Home> and <End> keys.  Left click on each to move to 
  164. that section of the dataset.  For example, click on the lower right corner 
  165. to move to the lower right portion of the dataset.  Note that in some data 
  166. sets, the upper right and lower left may result in mostly blank screens.  
  167. But if you scroll horizontally or vertically, you'll recover the data.  This 
  168. sounds more complicated than it is.  The easiest way to learn it is to 
  169. experiment with the datasets provided.  Click on each corner to see how the 
  170. view changes.  Then use the horizontal and vertical controls for finer 
  171. adjustments. 
  172.  
  173. Selection:
  174. Right click of the mouse button shows details of a person or event.  If a 
  175. person, it shows their age in the year of the last selected event.  If an 
  176. event, it shows the age of the last selected person.  Thus, to follow the 
  177. course of a person's life,  first select that person (right click on them), 
  178. then select the events you want to examine.  Each will be shown and the 
  179. person's age will be calculated.
  180.  
  181. KEYBOARD
  182. Scrolling:
  183.  
  184. Keyboard scrolling is handled by the arrow keys.  These are analagous to 
  185. using the mouse in sections 'b' & 'c'.  These keys scroll vertically and 
  186. horizontally, one row or column at a time.  To move to the corners, use the 
  187. <Home>, <End>, <PgUp> and <PgDn> keys.  Again, it's suggested you experiment 
  188. with the various keys to see how the screen changes.
  189.  
  190. To change from one section to another, use the <Ins> and <Del> keys.  You 
  191. can always tell which section you're in from the message displayed on the 
  192. bottom line.
  193.  
  194. Selection:
  195. The <F2> key will display details about the currently selected person or 
  196. event.  To change this selection, use the Keypad (Gray) '+' and '-' keys.
  197. This will move you to the next or previous item.
  198.  
  199. 3.2 SELECTIONS
  200.  
  201. This item lets you reduce or expand the number of people, events, factions 
  202. or groups that are displayed.  By combining these functions you can work 
  203. with smaller groupings.
  204.  
  205. Figure 6 shows the various possibilties for selection.  Choosing 'All' 
  206. resets any previously deselected items.  (This is the default when the 
  207. file is first read in.)
  208.  
  209. Selecting by 'Groups' or 'Factions' allows you to eliminate entire groups or 
  210. factions from the display.  
  211.  
  212. Selecting 'People' or 'Events' allows you to further reduce the selected 
  213. number of items.  If the previous selection was 'All', then you will start 
  214. with all items selected, and indicate which ones to remove.  If the previous 
  215. selection was 'Groups' or 'Factions' then only those people or events in the 
  216. indicated groups or factions will currently be selected.  You may deselect 
  217. items or add to the selected set.
  218.  
  219. When you next display the dataset, only selected items will appear.  The 
  220. file itself is unchanged, no matter whether items are selected or not.
  221.  
  222. Selection Keys:
  223. Picklists:
  224. Single choice (used for selecting an item to edit):
  225.       <Home>       -- first item
  226.       <end>        -- last item
  227.       <up arrow>   -- up one item
  228.       <down arrow> -- down one item
  229.       <PgUp>       -- move up one page of items
  230.       <PgDn>       -- move down one page of items
  231.  
  232. Multiple choice (used in the selection section):
  233.       <Ins>          -- selects an item
  234.       <Del>          -- deselects an item
  235.       <+> or <space> -- toggle between selected and deselected 
  236.       <Ctrl Enter>   -- Block toggle -- if no items are selected, select them
  237.                         all; if all are selected, deselect all.
  238.  
  239.       <enter>    -- select the current list
  240.  
  241. Mouse:
  242.  
  243.       <left button> -- select/deselect an item (the check mark will appear)
  244.  
  245. 3.3 REPORTS 
  246.  
  247. Figure 7 shows the various reports available.
  248.  
  249. The Text option prints the complete text of the dataset.  The People and 
  250. Events options print only those parts of the dataset.  The People report 
  251. includes Faction information and the Events report include group 
  252. information.
  253.  
  254. The Age report shows the age of all people who were alive for the currently 
  255. selected event.
  256.  
  257. 4. FILES
  258.  
  259. The Files selection from the main menu lets you open new files, save changed 
  260. ones, and also has several informational selections.
  261.  
  262. 'Open'    -- Shows, then reads from a list of currently available analyses.
  263.  
  264. 'New'     -- Prompts you for a name for a new analysis. 
  265.  
  266. 'Save'    -- Saves current analysis to disk 
  267.  
  268. 'WriteAs' -- Saves current analysis under a different file name 
  269.  
  270. 'About'   -- A brief summary of this program. 
  271.  
  272. 'Register' -- Details on how to register this shareware program.  If, after 
  273. an evaluation period, you decide you will continue to use the program, you 
  274. should register it.
  275.                    
  276.  
  277. 5. REQUIREMENTS 
  278.        
  279. CHRONOS has been optimized for use on a color monitor, but will also work on 
  280. monochrome screens.  It will use a Microsoft-compatible mouse if you have 
  281. one installed.  It is fully menu-driven.  To use the keyboard, you can 
  282. either use the arrow keys, or the first letter of a menu word to select the 
  283. action you wish.  Then press <enter>.  To use the mouse, just move it to the 
  284. item you want and press the left button.  To back up from a menu or to 
  285. finish an entry screen, press the right button, or <Esc>. 
  286.  
  287. 6. SHAREWARE & THE ASP
  288.  
  289. This program is shareware, which is a means of distributing software.  Under 
  290. the shareware concept, software may be freely copied and passed along to 
  291. others, or distributed through bulletin board systems or national networks. 
  292.  
  293. As a recipient of a shareware program, you may use the software for a short 
  294. trial period to determine if it meets your needs.  If the software is not 
  295. suitable, then you can discard it. If you decide to use it, you should 
  296. register it. CHRONOS costs $30 to register.  When you register, you will 
  297. receive a disk with the latest version of the program, updated datasets, plus 
  298. several other Cascoly utilities.  Registration also entitles you to online 
  299. support via CompuServe.  Send email to Cascoly Software, CompuServe number 
  300. 76703,3046.  (We will also answer mail from registered users.)        
  301.  
  302. As an additional benefit, registration entitles you to a free introductory 
  303. account on CompuServe.  (Details will be sent when you register.) 
  304.  
  305. Cascoly Software is a member of the Association of Shareware Professionals 
  306. (ASP).  ASP wants to make sure that the shareware principle works for you. 
  307. If you are unable to resolve a shareware-related problem with an ASP member 
  308. by contacting the member directly, ASP may be able to help. The ASP 
  309. Ombudsman can help you resolve a dispute or problem with an ASP member, but 
  310. does not provide technical support for members' products. You can contact 
  311. the ASP Ombudsman at P.O. Box 5786, Bellevue, WA 98006 or send a Compuserve 
  312. message via easyplex to ASP Ombudsman 70007,3536 
  313.  
  314. 7. REFERENCES
  315.  
  316. Several example datasets are included to illustrate the range of studies 
  317. possible using CHRONOS.  Users are encouraged to send interesting datasets 
  318. to Cascoly, and we will include them in future updates.  The Revolt and 
  319. Renaiss datasets were compiled from a variety of sources.  Some good 
  320. starting points would include the 'Who Was Who' books that can usually be 
  321. found in the reference section of libraries.  Another good source is an 
  322. unabridged dictionary.  They often have a section on famous people.  Some 
  323. historical periods have special dictionaries that are useful.  Eg, "The 
  324. Dictionary of the Napoleonic Wars", by David Chandler. 
  325.  
  326.  
  327. FIGURES:
  328. Figure 1: File menu
  329. Figure 2: People Menu & Entry Window
  330. Figure 3: Sample Edit picklist for People
  331. Figure 4: Events entry and editing
  332. Figure 5. Mouse Map for Display
  333. Figure 6: Selection Criteria
  334. Figure 7: Reports 
  335.  
  336.  
  337. 
  338. _______________________________________________________________________________
  339. Figure 1: File menu
  340. _______________________________________________________________________________
  341.  
  342.  
  343. ╒══════════════════════════════════════════════════════════════════════════════╕
  344. │ File     People      Event       Display      Select       Reports    Quit   │
  345. ╘═╒══════════╕═════════════════════════════════════════════════════════════════╛
  346.   │ Open     │                                                                  
  347.   │ New      │                                                                  
  348.   │ Save     │                                                                  
  349.   │ WriteAs  │                                                                  
  350.   │ About    │                                                                  
  351.   │ Register │                                                                  
  352.   ╘══════════╛                                                                  
  353.  
  354. _______________________________________________________________________________
  355. Figure 2: People Menu & Entry Window
  356. _______________________________________________________________________________
  357.  
  358. ╒══════════════════════════════════════════════════════════════════════════════╕
  359. │ File     People      Event       Display      Select       Reports    Quit   │
  360. ╘══════════╒══════════╕════════════════════════════════════════════════════════╛
  361.            │ Add      │                                                         
  362.            │ Edit     │                                                         
  363.            │ Delete   │                                                         
  364.            │ Factions │                                                         
  365.    ┌────────────────────────────────────────────────────────────────────────┐   
  366.    │Name                                                                    │   
  367.    │Description                                                             │   
  368.    │Faction  0                                                              │   
  369.    │Year of birth 1900                                                      │   
  370.    │Year of death 1900                                                      │   
  371.    └────────────────────────────────────────────────────────────────────────┘   
  372.                                                                                 
  373.  
  374. _______________________________________________________________________________
  375. Figure 3: Sample Edit picklist for People
  376. _______________________________________________________________________________
  377.  
  378. ╒══════════════════════════════════════════════════════════════════════════════╕
  379. │ File     People      Event       Display      Select      Reports     Quit   │
  380. ╘══════════╒══════════╕════════════════════════════════════════════════════════╛
  381.            │ Add      │                                                         
  382.            │ Edit     │                                                         
  383.            │ Delete   │                                                         
  384.            │ Factions │                                                         
  385.            ╘══════════╛                                                         
  386.                             ╒═════════ People ═════════╕                        
  387.                             │1732 George Washington    │█                       
  388.                             │1735 Paul Revere          │█                       
  389.                             │1741 Benedict Arnold      │█                       
  390.                             │1751 James Madison        │█                       
  391.                             │1769 Napoleon Bonaparte   │█                       
  392.                             │1819 Walt Whitman         │█                       
  393.                             │1833 J.E.B. Stuart        │█                       
  394.                             ╘══════════════════════════╛█                       
  395.                              ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀                       
  396. 
  397. _______________________________________________________________________________
  398. Figure 4: Events entry and editing
  399. _______________________________________________________________________________
  400.  
  401. ╒══════════════════════════════════════════════════════════════════════════════╕
  402. │ File     People      Event       Display      Select      Reports     Quit   │
  403. ╘══════════════════════╒══════════╕════════════════════════════════════════════╛
  404.                        │ Add      │                                             
  405.                        │ Edit     │                                             
  406.                        │ Delete   │                                             
  407.                        │ Groups   │                                             
  408.    ┌────────────────────────────────────────────────────────────────────────┐   
  409.    │Event                                  Group 0                          │   
  410.    │Description                                                             │   
  411.    │Year of event 1900                                                      │   
  412.    │                                                                        │   
  413.    └────────────────────────────────────────────────────────────────────────┘   
  414.  
  415. _______________________________________________________________________________
  416. Figure 5. Mouse Map for Display
  417. _______________________________________________________________________________
  418.                                                                                 
  419.  
  420.    ┌───┬────────────────────────────────────────────────┬───┐
  421.    │ a │                      c                         │ a │
  422.    ├───┼────────────────────────────────────────────────┼───┤
  423.    │   │                                                │   │
  424.    │   │                                                │   │
  425.    │ b │                                                │ b │
  426.    │   │                                                │   │
  427.    │   │                                                │   │
  428.    │   │                                                │   │
  429.    ├───┼────────────────────────────────────────────────┼───┤
  430.    │ a │                      c                         │ a │
  431.    ├───┴────────────────────────────────────────────────┴───┤ 
  432.    ├───┬────────────────────────────────────────────────┬───┤
  433.    │ a │                      c                         │ a │
  434.    ├───┼────────────────────────────────────────────────┼───┤
  435.    │   │                                                │   │
  436.    │ b │                                                │   │
  437.    ├───┼────────────────────────────────────────────────┼───┤
  438.    │ a │                      c                         │ a │
  439.    ├───┴────────────────────────────────────────────────┴───┤
  440.    └────────────────────────────────────────────────────────┘
  441.  
  442. Left Mouse Button:
  443.       a: Moves screen to requested corner of virtual screen.
  444.       b: Scrolls horizontally
  445.       c: Scrolls vertically
  446.  
  447. Right Mouse Button:
  448.       Middle line: moves date selector
  449.       Bottom line: selects command
  450.       Top or bottom section: selects a person or event
  451.  
  452. 
  453.  
  454. _______________________________________________________________________________
  455. Figure 6: Selection Criteria
  456. _______________________________________________________________________________
  457.                                                                                 
  458. ╒══════════════════════════════════════════════════════════════════════════════╕
  459. │ File     People      Event       Display      Select      Reports     Quit   │
  460. ╘═══════════════════════════════════════════════╒══════════╕═══════════════════╛
  461.                                                 │ All      │                    
  462.                                                 │ People   │                    
  463.                                                 │ Events   │                    
  464.                                                 │ Groups   │                    
  465.                                                 │ Factions │                    
  466.                                                 │ Scale    │                    
  467.                                                 ╘══════════╛                    
  468.  
  469. _______________________________________________________________________________
  470. Figure 7: Reports 
  471. _______________________________________________________________________________
  472.  
  473. ╒══════════════════════════════════════════════════════════════════════════════╕
  474. │ File     People      Event       Display      Select      Reports     Quit   │
  475. ╘═══════════════════════════════════════════════════════════╒════════╕═════════╛
  476.                                                             │ Text   │          
  477.                                                             │ People │          
  478.                                                             │ Events │          
  479.                                                             │ Ages   │          
  480.                                                             ╘════════╛          
  481.  
  482.  
  483.